home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / lreplace.n < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. lreplace(n)           Tcl Built-In Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      lreplace - Replace elements in a list with new elements
  12.  
  13. SYNOPSIS
  14.      lreplace _l_i_s_t _f_i_r_s_t _l_a_s_t ?_e_l_e_m_e_n_t _e_l_e_m_e_n_t ...?
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      Lreplace returns a new list formed by replacing one or  more
  20.      elements  of  _l_i_s_t  with the _e_l_e_m_e_n_t arguments.  _F_i_r_s_t gives
  21.      the index in _l_i_s_t of the first element to be  replaced.   If
  22.      _f_i_r_s_t  is less than zero then it refers to the first element
  23.      of _l_i_s_t;  the element indicated by _f_i_r_s_t must exist  in  the
  24.      list.   _L_a_s_t  gives the index in _l_i_s_t of the last element to
  25.      be replaced;  it must be greater than  or  equal  to  _f_i_r_s_t.
  26.      _L_a_s_t may be end (or any abbreviation of it) to indicate that
  27.      all elements between _f_i_r_s_t and the end of the list should be
  28.      replaced.   The  _e_l_e_m_e_n_t  arguments specify zero or more new
  29.      arguments to be added to the list in  place  of  those  that
  30.      were  deleted.  Each _e_l_e_m_e_n_t argument will become a separate
  31.      element of the list.  If no _e_l_e_m_e_n_t arguments are specified,
  32.      then the elements between _f_i_r_s_t and _l_a_s_t are simply deleted.
  33.  
  34.  
  35. KEYWORDS
  36.      element, list, replace
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.